home *** CD-ROM | disk | FTP | other *** search
/ Dr. Windows 3 / dr win3.zip / dr win3 / WINICONS / ICNDOS17.ZIP / ICONEDIT.DOC < prev    next >
Text File  |  1994-02-04  |  14KB  |  275 lines
  1.  
  2.  
  3.                                     ┌────┐
  4.                                  ┌──┴─┐┌─┴──┐
  5.                               ┌──┴─┐┌─┴┴─┐┌─┴──┐
  6.                            ┌──┴─┐┌─┴┴─┐┌─┴┴─┐┌─┴──┐
  7.                         ┌──┴─┐┌─┴┴─┐┌─┴┴─┐┌─┴┴─┐┌─┴──┐
  8.                         │    ├┤    ├┤    ├┤    ├┤    │
  9.                         └────┘└────┘└────┘└────┘└────┘
  10.                                     IconEDIT
  11.                                    ver. 1.2
  12.                           Copyright 1993, EFD Systems
  13.                                All Rights Reserved
  14.                         ┌────┐┌────┐┌────┐┌────┐┌────┐
  15.                         │    ├┤    ├┤    ├┤    ├┤    │
  16.                         └──┬─┘└─┬┬─┘└─┬┬─┘└─┬┬─┘└─┬──┘
  17.                            └──┬─┘└─┬┬─┘└─┬┬─┘└─┬──┘
  18.                               └──┬─┘└─┬┬─┘└─┬──┘
  19.                                  └──┬─┘└─┬──┘
  20.                                     └────┘
  21.  
  22.  
  23.  
  24.  
  25. ─────────────────────────────────────────────────────────────────────────────
  26.                          T A B L E  of  C O N T E N T S
  27.  
  28.  
  29.  Description  ----------------------------------------------------------- 3
  30.  
  31.  Installation and Startup  ---------------------------------------------- 4
  32.  
  33.  Building Menus  -------------------------------------------------------- 5
  34.  
  35.  Editing and Copying Icons  --------------------------------------------- 6
  36.  
  37.  Command Buttons  ------------------------------------------------------- 8
  38.  
  39.  How-To  ---------------------------------------------------------------- 9
  40.  
  41.  Mail Order  ------------------------------------------------------------ 11
  42.  
  43.  Maintenance Log  ------------------------------------------------------- 12
  44.  
  45.  
  46.  
  47.  
  48.  
  49. ───────────────────────────────────────────────────────────────────────────────
  50.                                   Description
  51.  
  52. IconEDIT is the graphical setup and maintenace utility for IconDOS. IconEDIT is
  53. used to build and edit icon menu files containing up to 32767 icons.  With
  54. IconEDIT you can draw your own icons from scratch or you can copy and modify any
  55. of the provided library icons.  At the same time, you can edit an icon's title
  56. and attach a DOS command string and password to the icon.
  57.  
  58. IconEDIT is almost totally mouse driven; therefore, a MicroSoft compatible mouse
  59. is required.  If a mouse driver is not present at startup, IconEDIT will abort
  60. with a short message.  IconEDIT also requires a VGA monitor (EGA will not work).
  61. This condition is also checked at startup.
  62.  
  63. IconDOS icons are always 32 by 32 pixels.  Wallpaper is also a 32 by 32 pixel
  64. graphic that is placed into a special file, PAPER.ICN, for display as a tiled
  65. backdrop pattern.  Therefore, IconEDIT does not make a distinction between icons
  66. and wallpaper and will edit either.  During editing, IconEDIT displays a normal
  67. and an expanded view of the icon.  Drawing with the mouse always takes place in
  68. the expanded view.
  69.  
  70. IconEDIT can now assign a 4 character password to an icon.  IconDOS requests the
  71. password before executing the icon's command string.  Passwords are case
  72. insensitive, i.e. caps and lower case are considered to be the same.
  73. ───────────────────────────────────────────────────────────────────────────────
  74.                             Installation and Startup
  75.  
  76. Installation is very easy.  Simply make a new directory and copy all of the
  77. IconDOS files to it.  If you insist, a batch file called INSTALL.BAT has been
  78. provided which will do this for you.  Change to the drive and directory where
  79. the IconDOS files are located and type:
  80.  
  81.                     INSTALL path   Example: INSTALL C:\MENU
  82.  
  83. To start IconEDIT, type:
  84.  
  85.                           ICONEDIT iconfile [buffile]
  86.  
  87. "iconfile" is the name of the file that you wish to edit.  The file will be
  88. created if it does not exist.  "buffile" is the name of an optional
  89. cut/copy/paste buffer file.  If "buffile" is not specified, IconEDIT will create
  90. and use a file called ICON.TMP.  The "buffile" is the key to copying and moving
  91. icons between files.  Try editing DEMO.MNU for practice.
  92.  
  93. NOTE: The buffer file grows in size with each CUT or COPY command.  ICON.TMP is
  94. never deleted or overwritten, only added to.  Therefore, you may wish to delete
  95. this file from time to time in order to prevent it from becoming excessively
  96. large.
  97. ───────────────────────────────────────────────────────────────────────────────
  98.                                  Building Menus
  99.  
  100. An icon menu file can be built by hand drawing icons using IconEDIT; however, it
  101. is easier and faster to copy icons from the provided icon library whenever
  102. possible.  Specific instructions for copying icons using IconEDIT are provided
  103. in the following section.  Icon titles, command strings and passwords can be
  104. attached to the icons.  Command strings are limited to 14 characters as imposed
  105. by the IBM keyboard buffer; therefore, the command string is normally used to
  106. call a batch file with a parameter.  The batch file actually contains the list
  107. of DOS commands needed to carry out specific icon actions.  A single batch file
  108. file can contain multiple sets of commands, one set for each icon in a menu.  In
  109. this case, an icon specific parameter should be included in the icon command
  110. string.  This parameter can be used inside the batch file to select the proper
  111. DOS command set.  RUN.BAT is a fully commented batch file which illustrates this
  112. technique.  This file can be modified for your own needs as desired.  This batch
  113. file is also used to make the menu system re-entrant by returning control to
  114. IconDOS after a command set has been executed.  Comments in RUN.BAT also
  115. illustrate this.
  116.  
  117. To allow IconDOS to operate from any directory, the batch file containing the
  118. DOS command sets should be located somewhere inside your DOS path.  IconDOS can
  119. be accessed from outside the IconDOS directory by specifying the full path for
  120. both IconDOS and menu file like this:  C:\MENU\ICONDOS C:\MENU\DEMO
  121. ───────────────────────────────────────────────────────────────────────────────
  122.                            Editing and Copying Icons
  123.  
  124. As noted earlier, IconDOS is mostly mouse driven.  Notes on-screen explain how
  125. the CTRL and ALT keys will modify certain mouse actions.  The keyboard is only
  126. used to enter and edit icon titles, command strings and passwords.
  127.  
  128. All drawing takes place in the expanded view of the icon.  Individual pixels are
  129. painted by clicking inside a pixel box.  Lines can be drawn by holding down a
  130. mouse button and moving the cursor.  A wide brush (3 X 3 pixels) is available
  131. for filling in larger regions by holding down the ALT key while drawing.
  132.  
  133. The left and right mouse buttons can be assigned drawing colors by clicking on
  134. the color bar.  To erase instead of draw, simply assign the background color to
  135. one of the buttons and draw over the area to be erased.
  136.  
  137. Note that you must explicitedly store your artwork to disk by clicking either
  138. the SAVE or APPEND command buttons; otherwise, your work will be lost when you
  139. leave IconEDIT or move to the next icon.
  140.  
  141. To edit a title, command string or password, click inside the labeled edit box.
  142. The mouse is disabled until editing is terminated by ENTER or ESC.  The box
  143. editor provides Insert and Overstrike modes toggled with INSERT.  Alt-C will
  144. clear the box, Alt-R will restore.  Home and End move to the box start/end.
  145. ───────────────────────────────────────────────────────────────────────────────
  146.                        Editing and Copying Icons (cont'd)
  147.  
  148. When building a menu, it is generally preferable to copy an icon from the
  149. provided library, ICON.LBR, instead of drawing your own icon from scratch.
  150.  
  151. To copy icons between files, start IconEDIT in the following manner:
  152.  
  153.                            ICONEDIT fromfile tofile
  154.  
  155. For example, to copy icons from ICON.LBR to MYMENU.MNU, start IconEDIT with:
  156.  
  157.                           ICONEDIT ICON.LBR MYMENU.MNU
  158.  
  159. Click on the small actual size icon (upper right) for a full screen display of
  160. the available icons.  The buttons at the extreme upper right are used to flip
  161. screens/pages.  Click the desired icon to bring it int